Copyright: MicroHelp


Help Contents
Contents

Report Generator

Using the Designer

Overview

Objects Defined

Creating Objects

Selecting Objects

Resizing and Moving Objects

Designer Components

Designer Menu Options

Text Characteristics Dialog

Editing Text

Inserting and Deleting Lines

Modifying Text Attributes

Rectangle Characteristics Dialog

Line Characteristics Dialog

Load Picture Dialog

Barcode Definitions Dialog

Table Entries Dialog

Page Setup Dialog (Labels)

Page Setup Dialog (Lists)


Report Generator

The MicroHelp

Report Generator

Version 1.10

Software

Licensed from Combit GmbH

Documentation

Mark E. Novisoff

Acknowledgements

Trademarks

The following trademarks are used throughout this manual. Whenever you come across them, please remember that they are the trademarks or registered trademarks of the companies shown below.

Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation.

All other names are trademarks or registered trademarks of their respective owners.

Many product names are used in this manual for illustrative purposes only. Use of these product names does not imply endorsement of the product by MicroHelp, or endorsement of MicroHelp by the product vendor.

Published by

MicroHelp, Inc.

4359 Shallowford Industrial Parkway

Marietta, Georgia 30066

U.S.A.

(404) 516-0898

9:00 A.M. to 5:00 P.M. Eastern Time

Please! Before calling for technical support, we would appreciate it if you would review the following:

•	The READ.ME file, installed to the program directory by Setup

Copyright © 1992 MicroHelp, Inc. and Combit GmbH

All rights reserved

Printed in the United States of America.


Using the Designer - Overview
Overview

The MicroHelp Report Generator interacts with the user to position lines, rectangles and pictures ("Objects") on the output device (label or columnar report) and to define variables that are replaced with data at runtime.

Before you invoke the Designer, the variables and/or fields (see Chapter 3, Fundamentals) that can be manipulated by the user are defined by the programmer.

Once you've defined the variables and fields that appear in a report, you're ready to call up the Designer. This is done by invoking the LLDefineLayout function

X% = LLDefineLayout(JobHandle%, Modal%, wCaption$, ObjType%, FileName$)

where

JobHandle% = The job number returned by LLJobOpen

Modal% = HWND property of your form (modal operation) or zero for non-modal

wCaption$ = Designer dialog caption

ObjType% = OBJECT_LABEL or OBJECT_LIST (see LL_DEFS.BAS)

FileName$ = Report definition file

Invoking the LLDefineLayout function causes the Designer dialog to open, at which point you or the user can define reports.

Once you invoke the Designer (by calling the LLDefineLayout procedure in the DLL), no further programming is required -- the DLL contains all the code necessary to handle the design work.


Objects Defined

The MicroHelp Report Generator offers six types of objects, described below. Before you can edit an object, you must select it. (Note that when you create a new object, it automatically becomes the selected object.) Instructions for selecting objects are given in the next section of this chapter.

Here are the currently supported object types:

Related Topics:

Text and variables

Rectangle

Line

Picture

Barcode

Table


Text and variables

In this context, "Text" refers to a set of characters that are typed once and then printed on each report. In some cases, "Text" is replaced with data when a report is printed.

"Variables" refers to replaceable parameters you define as described under Variables.

From this point on, we'll use "Text" to refer to both Text and Variables.

You can place Text objects in any type of report (i.e., list reports and label reports). Text objects can include page numbers, dates and data variables you define.


Rectangle

A Rectangle Object is similar to a Visual Basic Frame control. It can be used on its own or as a container for other Objects.


Line

A Line Object is similar to a Visual Basic Picture Control, except that it can be used for diagonal lines, as well as horizontal and vertical lines. Line Objects cannot be containers for other Objects.


Picture

A Picture Object is just like a Visual Basic Picture Control, in that it's used to place pictures on reports.


Barcode

A Barcode Object is used to generate barcodes, typically when printing product labels or other types of labels.


Table

A Table Object is used to generate columnar lists of data. A Table Object can have an optional header (column title) as well. The data you place in the Table can be either variables or fields.


Creating Objects

Tools and Shortcut Keys for Creating Objects

Object Type	Tool in Toolbox	Shortcut Key
Text		<Ctrl-T>
Rectangle		<Ctrl-R>
Line		<Ctrl-L>
Drawing		<Ctrl-P>
Barcode		<Ctrl-B>
Table		<Ctrl-E>

To create an object:

•	Either click on the appropriate tool in the Toolbox, use the Object menu option or press the shortcut key for the desired object. (Note that once you pick a tool, the mouse pointer changes to an "X" shape when it passes over the Edit Window.)

•	Position the mouse pointer at the point where you want the top, left corner of the object.

•	Press and hold left mouse button and draw the object, exactly like you do when creating a Visual Basic control.

•	When the object is the desired size, release the left mouse button.


Selecting Objects

: The status line must show "Select" before you can select one or more objects. If you don't see the word "Select", it means you are drawing an object using the selected tool. In this case, click on the Arrow Tool [image], which causes "Select" to appear on the status line.

You can select one or more objects using either the mouse or the keyboard.

Selecting a Single Object

Selecting an object is accomplished using any of the following methods:

•	Click the left mouse button while the mouse pointer is on the object's outline.

•	 Use the Arrow Tool. First select the arrow tool, then position the mouse pointer outside of the object you want to select, press and hold the left mouse button, and drag the mouse so the resulting outline completely surrounds the object you want to select. Note that the drag operation must be started while the mouse pointer is in the "white space" portion of the editing window.

•	Use the Object-Select menu option.

Selecting Multiple Objects

Selecting multiple objects is accomplished using any of the following methods:

•	Hold the <Shift> key and click the left mouse button while the mouse pointer is on an object's outline. With the <Shift> key held down, continue clicking on object outlines until all the desired objects have been selected.

•	Use the Arrow Tool. First select the arrow tool, then position the mouse pointer outside of all the objects you want to select, press and hold the left mouse button, and drag the mouse so the resulting outline completely surrounds all the objects you want to select. Note that the drag operation must be started while the mouse pointer is in the "white space" portion of the editing window.

•	Use the Object-Select All menu option.


Resizing and Moving Objects

Resizing Objects

Once an object has been selected, the mouse pointer changes to "sizing" shape whenever it passes over the border of the object.

To resize the the object, press and hold the left button when the mouse pointer takes on the "sizing" characteristics, drag the outline to the desired size and then release the button.

If multiple objects are selected, the mouse pointer changes to the sizing shape when it passes over the border of the frame encompassing the objects. You can resize all selected objects by resizing the frame.

Moving Objects with the Mouse

When an object is selected, a small box appears in the center of the object. When the mouse pointer passes over this box, it takes on the "directional" shape.

To move an object, press and hold the left button when the mouse pointer takes on the "directional" characteristics, drag the outline to the desired location and then release the button.

If multiple objects are selected, the small box appears in the center of the frame and the mouse pointer changes to the directional shape when it passes over the border of the frame encompassing the objects. You can move all selected objects by moving the box within the frame.

Moving Objects with the Keyboard

Each keypress moves the object(s) 0.01 inches in the indicated direction. Holding the <Shift> key and pressing an arrow key moves the object 0.10 inches in the indicated direction.

Use the up, down, left and right arrows to move in the indicated direction. The <Home> key moves the object(s) diagonally up and to the left. The <PgUp> key moves the object(s) diagonally up and to the right. The <End> key moves the object(s) diagonally down and to the left. The <PgDn> key moves the object(s) diagonally down and to the right.


Designer Components

Here's how the designer appears when you first invoke the LLDefineLayout function:

Note: When the Designer is active, pressing the <Tab> key toggles the Preview Window (described later) between full-screen mode and partial view mode.

Related Topics:

Rulers

Toolbox

Editing Window

Preview Window

Status Line


Rulers

The horizontal and vertical rulers are used to determine the size and position of objects within the editing window.


Toolbox

The toolbox gives you a quick access to the most common objects and operations. Once you are comfortable with the Designer, using the Toolbox is a quick and simple way to select a command or object.


Editing Window

Framed by the Rulers, this is where you define the objects that appear in your reports.


Preview Window

The Preview Window shows you how your report will look when it's printed. You can move or resize the Preview Window at will. Any changes you make to its size or placement are saved between sessions.

When the mouse pointer is moved over the Preview Window it changes shape to that of a magnifying glass with a plus sign "+" in the glass. If you click on the Preview Window, the size toggles to full-screen mode (just as though you had pressed the <Tab> key) and the plus sign changes to a minus sign "-". Clicking on the Preview Window when the minus sign is visible, causes the window to revert to its normal state, with a plus sign.


Status Line

The status line consists of three components:

•	The cursor position area shows you the exact position of the cursor, in inches, relative to the top, left portion of the printed page.

•	The middle area shows you the Designer mode: The caption will be either "Select" (meaning you should select an object, a tool or a command) or a caption that indicates the tool with which you are working.

•	The right portion of the status line tells you the type and size of the currently selected object.


Designer Menu Options

Note: Where a menu option can be invoked by pressing a button on the Toolbox, the button for the command is shown next to the menu option description.

Related Topics:

File Menu

Edit Menu

Object Menu

Arrange Menu

Zoom Menu

Options Menu


File Menu

New

Open

Save

Save As

Print Sample

Page Setup

Exit


New

Creates a new report. If you've made changes to the report you are currently editing, you'll be prompted to save those changes.


Open

Opens an existing report definition file via the Windows COMMDLG routines.  If you've made changes to the report you are currently editing, you'll be prompted to save those changes.


Save

Saves editing changes to the current report definition file. If a current file name hasn't yet been established (as is the case after using File-New), you'll be prompted just as though you had selected File-Save-As.


Save As

Saves the report definition file to a new name.


Print Sample

Uses the variables you have defined to print a one-page example of the report to the printer. If you select this option for a label report, the edges of the label will be identified with lines so you can assure proper paper alignment in the printer. (The lines don't appear in the actual reports - only in the sample.)


Page Setup

Opens a dialog that lets you position the printed reports on the printed page. For complete instructions, please refer to Page Setup Dialog (Labels) and Page Setup Dialog (Lists).


Exit

Exits the Designer and returns control to the calling program.


Edit Menu

Undo <Alt-Bksp>

Delete <Del>

Cut to Clipboard <Shift-Del>

Copy to Clipboard <Ctrl-Ins>

Paste from Clipboard <Shift-Ins>


Undo <Alt-Bksp>

Returns the current object to the state it was in before the last operation was performed. Undo is available for the most recent ten operations performed.


Delete <Del>

Deletes the selected object(s). When you delete objects, they are not stored in the clipboard and therefore cannot be recovered by pasting from the clipboard. You can recover a deleted object by using the Undo menu option.


Cut to Clipboard <Shift-Del>

Deletes the selected object(s) and stores to the Windows clipboard. The object(s) can be pasted to the same report or to other reports. Note that cutting to the clipboard erases any previously cut objects that might have been stored in the clipboard.


Copy to Clipboard <Ctrl-Ins>

Copies the selected object(s) to the Windows clipboard. The object(s) can be pasted to the same report or to other reports. Note that copying to the clipboard erases any previously cut objects that might have been stored in the clipboard.


Paste from Clipboard <Shift-Ins>

If the Windows clipboard contains one or more objects that were cut or copied to the clipboard, this selection pastes the object(s) into the report.


Object Menu

Select <Ctrl-S>

Select All <Ctrl-A>

Toggle Selection <Ctrl-Y>

Next object <Numpad +>

Previous object <Numpad ->

Edit object <Enter>

Text <Ctrl-T>

Rectangle <Ctrl-R>

Line <Ctrl-L>

Picture <Ctrl-P>

Barcode <Ctrl-B>

Table <Ctrl-E>


Select <Ctrl-S>

Selects the Arrow Tool  in the Toolbox. This changes the mode from Draw mode to Select mode.


Select All <Ctrl-A>

Selects all objects in the Editing Window so you can move them en masse.


Toggle Selection <Ctrl-Y>

Selects all objects that are not currently selected and deselects all objects that are currently selected.


Next object <Numpad +>

Deselects the currently selected object and selects the next object (in the order in which the objects were created). This menu option is available only when precisely one object is selected.


Previous object <Numpad ->

Deselects the currently selected object and selects the previous object (in the order in which the objects were created). This menu option is available only when precisely one object is selected.


Edit object <Enter>

Opens a dialog so that you can edit the appearance and/or content of the selected object. This menu option is available only when precisely one object is selected. (The dialogs for the different object types are described later in this chapter, beginning with Text Characteristics Dialog.


Text <Ctrl-T>

This option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Rectangle <Ctrl-R>

This  menu option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Line <Ctrl-L>

This  menu option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Picture <Ctrl-P>

This  menu option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Barcode <Ctrl-B>

This  menu option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Table <Ctrl-E>

This menu option has the same effect as clicking on the object's tool in the Toolbox. Once you've selected this menu option, you are in "draw" mode and you use the mouse to size the object.


Arrange Menu

Note: The Arrange menu options are handy when you have overlapping objects or objects that are completely hidden by other obects. All the options are used to change the "layer" at which objects appear within the Edit Window. For example, consider the "top" to be level 1, the next layer is two, and so on.

Related Topics:

To Front <Ctrl-Home>

To Back <Ctrl-End>

Forward One <Ctrl-PgUp>

Back One <Ctrl-PgDn>


To Front <Ctrl-Home>

The selected object(s) are placed on top of any other objects. In other words, the objects appear on layer 1.


To Back <Ctrl-End>

The selected object(s) are placed underneath any other objects. In other words, the objects will appear on layer n, where n is the lowest layer.


Forward One <Ctrl-PgUp>

The selected object(s) appear in the next layer closest to the top layer.


Back One <Ctrl-PgDn>

The selected object(s) appear in the next layer closest to the bottom layer.


Zoom Menu

The Zoom menu changes the magnification and view port of the Editing Window.

Related Topics:

Full View <Alt-1>

2 Times <Alt-2>

4 Times <Alt-3>

8 Times <Alt-4>


Full View <Alt-1>

Provides the normal, unzoomed view of the Editing Window.


2 Times <Alt-2>

All Objects appear two times as large as the normal scale.


4 Times <Alt-3>

All Objects appear four times as large as the normal scale.


8 Times <Alt-4>

All Objects appear eight times as large as the normal scale.


Options Menu

The Options menu is used to set your choice of colors, default values and other features.

Related Topics:

Window Colors

Default values for objects

Display Text in Work Area

Full Page Preview (Label Reports Only)

Fast Preview


Window Colors

Background of Dialogs, Work area and Preview

Shadow of Dialogs and Preview

Rulers Background

Rulers Foreground

Label Background (Preview)

Label Foreground (Preview)


Background of Dialogs, Work area and Preview

Sets the background color of all dialogs, the Edit Window and the Preview Window.


Shadow of Dialogs and Preview

Sets the shadow color for all dialogs and the Preview Window


Rulers Background

Sets the background color used on both rulers.


Rulers Foreground

Sets the foreground color used on both rulers.


Label Background (Preview)

Sets the background color for labels displayed in the Preview Window.


Label Foreground (Preview)

Sets the foreground color for labels displayed in the Preview Window.


Default values for objects

Color of Lines and Frames

Sets the default color for Line Objects and the border color for Rectangle Objects.

Related Topics:

Fill Color

Font


Fill Color

Sets the default color used to fill Rectangle Objects.


Font

Sets the default font used for Text Objects.


Display Text in Work Area

Check this menu option if you want a rough approximation of the text in a Text Object displayed in the Editing Window. Note that for complex reports, where you have a large number of Objects in the Editing Window, checking this option causes the repaint of the Editing Window to be slower.


Full Page Preview (Label Reports Only)

When this menu option is checked, the Preview Window shows you a full page of labels. You can speed up the repainting of the Preview Window by deslecting this option, causing the Preview Window to display oly a single label.


Fast Preview

Checking this menu option causes the Preview Window to display an abbreviated image of the report, thus speeding up the repaint of the Preview Window. For Picture Objects, only the name of the file is shown. For List Reports, only a portion of the page is shown.


Text Characteristics Dialog

When a Text Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

Text Objects are line-oriented and all lines comprising the object are presented in a list box.

Note: There is a limit of 20 lines of text per Text Object.


Editing Text

•	Select the line you want to edit.

Either double-click the line you want to change or highlight the line and press the Change button. Note that you can mix and match any of the next three steps on any line. At this point, the Edit Textline Dialog appears:

•	Enter any desired fixed text you want to be printed on this line.

Do so by typing the text into the text box.

•	Press the Variable button if you want to insert a defined variable.

A list box containing the defined variables is presented. Select the desired variable name by highlighting it and clicking the OK button or by double-clicking on the desired variable. Note that the variable name is surrounded by angled brackets <>.

•	Press the Condition button.

Conditions are used to selectively print text and variables, based on whether a data field contains data or not.. The program will automatically place the characters « ¦ ¦ » at the current insertion point. Fill out the condition using the following syntax:

« field|text if not empty ¦ text if empty »

The « and » characters signify the beginning and end of  a conditional sequence. The | character separates the components of the conditional sequence. "field" indicates the variable or field to test for the presence of data. "text if not empty" indicates what should be printed if "field" is not empty and "text if empty" indicates what should be printed otherwise.

A good example is a label where you want to print the first names of a man and woman (when you know both names), but you only want to print the man's name if you don't know the woman's. In this case, your condition might look like this:

<man>«<woman>|and ¦ » <woman>

Given the above scenario, the report will always print the man's name and the woman's name (even when empty), but it will print "and " only when the woman's name is not empty.


Inserting and Deleting Lines

The Line frame is used to Change, Insert and Delete lines from the text object. To perform those functions:

•	Select a line by highlighting it

•	Press one of the Change, Insert or Delete buttons

Note: When you want to Change a line, double-clicking on the line has the same effect as highlighting the line and then pressing the Change button.


Modifying Text Attributes

Note: By default, each line takes on the font that you set in the Options-Default Values for Objects menu option. If the default font is acceptable, you don't need to change the font using this dialog.

•	Select the line you want to edit.

Highlight the line.

•	Set the Alignment.

Choose Left, Center or Right alignment.

•	Set the Line Spacing

Use the Spin control to set the line spacing, in points. This value represents the amount of space between the selected line and the next line. For example, if you are using a 10 point font, and you want one half of a line between lines, set the line spacing to 5 points.

•	Choose a Font

To change the font, click on the Select button  to open the Windows ChooseFont dialog. To use the default font (as selected in the Options-Font menu), press the Default button.

•	Decide if Line Should Always Print

If the line contains a field or variable, and you want to suppress printing of the line when the field/variable is empty, check the Permanent check box.

•	Decide if Word Wrap Should be Used

Check the Word Wrap box if you want the text for this line to wrap to the next line when there is too much text to fit on a single line. If the text is too long, and you don't check this box, the data will be truncated when printed.


Rectangle Characteristics Dialog

When a Rectangle Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

Related Topics:

Border

Fill


Border

Note: By default, the border takes on the color that you set in the "Options-Default Values for Objects-Colors of Lines and Frames" menu option. If the default color is acceptable, you don't need to change it using this dialog.

•	Determine if You Want a Border

If you don't want a border, check the "No Border" option button. If you do want a border, use the next two controls to format the border.

•	Choose the Border Color

Press the Color button to open the Windows ChooseColor dialog.

•	Set the Border Size

Use the spin control to set the size of the border, in increments of 0.01 inch.


Fill

Note: By default, the fill color is the color that you set in the "Options-Default Values for Objects-Fill Color" menu option. If the default color is acceptable, you don't need to change it using this dialog.

•	Determine if You Want a Transparent Rectangle

If you want a transparent Rectangle, check the Transparent option button.

•	Choose the Fill Color

If you want the rectangle to be filled with a color, press the Color button to open the Windows ChooseColor dialog.


Line Characteristics Dialog

When a Line Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

Related Topics:

Line Characteristics


Line Characteristics

Note: By default, the line takes on the color that you set in the "Options-Default Values for Objects-Colors of Lines and Frames" menu option. If the default color is acceptable, you don't need to change it using this dialog.

•	Set the Line Width

Use the spin control to set the size of the line, in increments of 0.01 inch.

•	Choose the Line Color

Press the Color button to open the Windows ChooseColor dialog.


Load Picture Dialog

When a Picture Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

This dialog is the standard Windows GetOpenFileName dialog.

You can load the following picture types into a Picture Object:

•	.BMP Bitmap

•	.RLE Bitmap (run-length encoded)

•	.DIB Bitmap (device-independent)

•	.WMF Metafile (Aldus format)


Barcode Definitions Dialog

When a Barcode Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

Note: By default, barcodes are printed using the font defined in the "Options-Default Values for Objects-Font dialog. The default color is the one you set in the "Options-Default Values for Objects-Colors of Lines and Frames" menu option. If the default font is acceptable, and the default color is acceptable, you don't need to change either using this dialog.

•	Select a Barcode Style

Use the list box on the left to choose the style.

•	Select a Font

Press the Font button to open the ChooseFont common dialog or press the Default button to use the default font.

•	Select a Color

If you don't want to use the default color, press the Barcode button to open the ChooseColor common dialog and select a color.

•	Choose Text Mode

If the barcode style you select allows printing of text beneath the barcode, and you want the text displayed, check the Display check box. If you don't want the text displayed, uncheck the check box.


Table Entries Dialog

When a Table Object is selected, you can open this dialog by either pressing the Edit tool in the Toolbox, by pressing the <Enter> key or by using the Object-Edit object menu option

•	Select the Fields you want in the Table

The Fields are entered into the list box on the left. Press the Insert Field button to see a list of the available fields. As you select each Field, the Preview Window is modified to give you an idea of  what the Table portion of the report looks like.

Note: The name of each field appears at the top of the column on each page of the report. Therefore, be sure to define the Field names to what you want to show as the title for the column!

•	Assign Field Attributes

Change the column Width, in 0.01 inch increments, using the spin button. We recommend you allow for total margin space of 0.2 inches, which provides 0.1 inches on each side.

Choose the alignment you want. If you select Decimal tab alignment, use the spin control to adjust the tab positions in 0.01 inch increments. Note that for the decimal character, the DLL uses the character specified for sDecimal in WIN.INI.

Select whether field contents should wrap to the next line if too long to fit within the column (select the Word Wrap option) or choose the None option if you want the data to be truncated.

•	Define the Table Layout

Press the Table Layout button (see below for details).

•	Delete any unwanted fields

Press the Delete field button to delete the selected field.

Related Topics:

Table Layout Dialog


Table Layout Dialog

(This dialog is opened when you press the Table Layout button on the Table Entries dialog.)

Note: By default, the header and body take on the font that you set in the Options-Default Values for Objects menu option. If the default font is acceptable, you don't need to change the font using this dialog.

•	Choose Header Font

Press the Default button to accept the default font or press the Select button to change the font via the ChooseFont common dialog.

•	Choose Body Font

Press the Default button to accept the default font or press the Select button to change the font via the ChooseFont common dialog.

•	Determine Line Spacing

Use the spin control to change the line spacing, expressed in points. This is the amount of space between the lines and does not include the printed line itself. For example, if you want lines 15 points apart, and your font is 10 points, specify line spacing of 5 points.

•	Choose Frame and Divider Options

If you want a border printed around the Table Object, check the Frame check box. If you want a line printed between each line of data, check the Horizontal Separators check box. If you want a vertical line printed between columns, check the Vertical Separators check box.


Page Setup Dialog (Labels)

Note: The appearance of the Page Setup Dialog depends on the type of report you are defining. This section describes the appearance when you are editing a label report. See Page Setup Dialog (Lists) for details on Page Setup Dialog (Lists).

Description is a string you can use to describe the report.

Page is the size, in inches, of the paper used to print the report. These values are determined automatically from the currently selected printer.

Offset specifies the amount of blank space (horizontal and vertical) between the edges of the paper and the first label printed.

Size specifies the size, in inches, of a single label (i.e., a blank label). This means the size of one label on the label sheets or continuous forms you feed to the printer. Enter the width of the label in the horizontal column and the height of the label in the vertical column.

Distance - horizontal specifies the space, in inches, between the left edge of the one label and the left edge of the label to the right of it. This value includes the width of the label as well as the blank space between the labels (horizontally).

Note: When Number (see below) is one, indicating "one up" labels, only the vertical distance value must be specified.

Distance - vertical specifies the space, in inches, between the top edge of the one label and the top edge of the label beneath it. This value includes the height of the label as well as the blank space between the labels (vertically).

Number - horizontal indicates the number of labels per row. Typically this is one (for "one up") or four (for Cheshire labels, for example).

Number - vertical specifies the number of rows of labels per page.

Printer button, when pressed, causes the Windows Printer Setup dialog to open.


Page Setup Dialog (Lists)

Note: The appearance of the Page Setup Dialog depends on the type of report you are defining. This section describes the appearance when you are editing a list. report. See page for details on Page Setup Dialog (Labels).

Page is the size, in inches, of the paper used to print the report. These values are determined automatically from the currently selected printer.

Description is a text box you can use to describe the report.

Offset specifies the amount of blank space (horizontal and vertical) between the top, left edge of the paper and the first data printed.